home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 31 / PC Actual CD 31.iso / dists / INSTALL.TXT < prev    next >
Encoding:
Text File  |  1998-10-16  |  23.5 KB  |  514 lines

  1. +=====================  Installing FreeBSD  ==========================+
  2. |                                                                     |
  3. | Table of Contents:                                                  |
  4. |                                                                     |
  5. | 0.0     Quick Start:                                                |
  6. |         0.1     Installing FreeBSD from CDROM or the Internet.      |
  7. |                                                                     |
  8. | 1.0     Detail on various installation types:                       |
  9. |         1.1     Installing from a network CDROM                     |
  10. |         1.2     Installing from Floppies                            |
  11. |         1.3     Installing from a DOS partition                     |
  12. |         1.4     Installing from QIC/SCSI tape                       |
  13. |         1.5     Installing over a network using NFS or FTP          |
  14. |                 1.5.1   NFS Installation tips                       |
  15. |                 1.5.2   FTP Installation tips                       |
  16. |                                                                     |
  17. | 2.0     DOS User's Q&A section.                                     |
  18. |         2.1     How do I make space for FreeBSD?                    |
  19. |         2.2     Can I use compressed DOS filesystems from FreeBSD?  |
  20. |         2.3     Can I use DOS extended partitions?                  |
  21. |         2.4     Can I run DOS executables under FreeBSD?            |
  22. |                                                                     |
  23. +=====================================================================+
  24.  
  25. Author:         Jordan K. Hubbard
  26. Last updated:   Tue Mar 24 00:56:14 PST 1998
  27.  
  28. 0.0     Quick Start
  29. ---     -----------
  30.  
  31. This manual documents the process of making a new installation of
  32. FreeBSD on your machine.  If you are upgrading from a previous
  33. release of FreeBSD, please see the file UPGRADE.TXT for important
  34. information on upgrading.  If you are not familiar with configuring
  35. PC hardware for FreeBSD, you should also read the HARDWARE.TXT file -
  36. it contains important information which may save you a lot of grief.
  37.  
  38. If you're new to FreeBSD then you should also read EVERYTHING listed
  39. in the Documentation menu on the boot floppy.  It may seem like a lot
  40. to read, but the time you spend now reading the documents will be made
  41. up many times over because you were adequately prepared. Also, you will
  42. know the types of information available should you get stuck later.
  43. Once the system is installed, you can also revisit this menu and use a 
  44. WEB browser to read the installed FAQ (Frequently Asked Questions) and 
  45. Handbook HTML documentation sets for FreeBSD.  You can also use the 
  46. browser to visit other WEB sites on the net (like http://www.freebsd.org)
  47. if you have an Internet connection. See ABOUT.TXT for more information
  48. on the resources available to you.
  49.  
  50. The best laid plans sometimes go awry, so if you run into trouble take a 
  51. look at TROUBLE.TXT which contains valuable troubleshooting information.
  52.  
  53. DISCLAIMER: While FreeBSD does its best to safeguard against
  54. accidental loss of data, it's still more than possible to WIPE OUT
  55. YOUR ENTIRE DISK with this installation!  Please do not proceed to the
  56. final FreeBSD installation menu unless you've adequately backed up any
  57. important data first!  We really mean it!
  58.  
  59. FreeBSD requires a 386 or better processor to run (sorry, there is no
  60. support for '286 processors), 5 megs of RAM to install and 4 megs of
  61. ram to run. You will need at least 80 megs of free hard drive space.
  62. See below for ways of shrinking existing DOS partitions in order to
  63. install FreeBSD.
  64.  
  65.  
  66. 0.1     Installing FreeBSD from CDROM or the Internet
  67. ---     ---------------------------------------------
  68.  
  69. The easiest type of installation is from CD.  If you have a supported
  70. CDROM drive and a FreeBSD installation CD from Walnut Creek CDROM,
  71. there are 3 ways of starting the installation from it:
  72.  
  73.         1. If your system supports bootable CDROM media (usually an option
  74.            which can be selectively enabled in the controller's setup menu
  75.            or in the PC BIOS for some systems) and you have it enabled,
  76.            FreeBSD 2.2.1 and later CDs support the "El Torrito" bootable
  77.            CD standard.  Simply put the installation CD in your CDROM drive
  78.            and boot the system to begin installation.
  79.  
  80.         2. If you have drivers which allow you to see your CDROM drive
  81.            from from DOS, first disable any fancy memory managers you may
  82.            have configured, change directory to the CDROM (E:\ in the example
  83.            below) and then type this:
  84.  
  85.                 E> install
  86.  
  87.            and you should boot directly into the FreeBSD installation.
  88.  
  89.            If either steps fail, please go on to step 3.
  90.  
  91.         3. Build a FreeBSD boot floppy from the floppies/boot.flp
  92.            file in a FreeBSD distribution.  Either simply use the
  93.            ``makeflp.bat'' script from DOS or read floppies/README.TXT
  94.            for more information on creating bootable floppies under
  95.            different operating systems.  Then you simply boot
  96.            from the floppy and you should go into the FreeBSD
  97.            installation.
  98.  
  99. If you don't have a CDROM and would like to simply install over the
  100. net using PPP, slip or a dedicated connection, simply fetch the
  101. <FreeBSD-release>/floppies/boot.flp file from:
  102.  
  103.         ftp://ftp.freebsd.org/pub/FreeBSD
  104.  
  105. or one of its many mirrors (http://www.freebsd.org/handbook/mirrors.html)
  106. and follow step 3 above.  You should also read the floppies/README.TXT
  107. file as it contains important information for downloaders.
  108.  
  109. Once you have a boot floppy made, please go to section 1.5 of this
  110. document for additional tips on installing via FTP or NFS.
  111.  
  112.  
  113. 1.0     Detail on various installation types
  114. ---     ------------------------------------
  115.  
  116. Once you've gotten yourself to the initial installation screen
  117. somehow, you should be able to follow the various menu prompts and go
  118. from there.  If you've never used the FreeBSD installation before, you
  119. are also encouraged to read some of the documentation in the the
  120. Documentation submenu as well as the general "Usage" instructions on
  121. the first menu.
  122.  
  123.    REMEMBER:  If you get stuck at a screen, hit F1 for the online
  124.    documentation for that section.
  125.  
  126. If you've never installed FreeBSD before, or even if you have, the
  127. "Novice" installation mode is the most recommended since it makes sure
  128. that you'll visit all the various important checklist items along the
  129. way.  If you're much more comfortable with the FreeBSD installation
  130. process and know _exactly_ what you want to do, use the Express or
  131. Custom installation options.  If you're upgrading an existing system,
  132. use the Upgrade option.
  133.  
  134. The FreeBSD installer supports the direct use of floppy, DOS, tape,
  135. CDROM, FTP, NFS and UFS partitions as installation media, further tips
  136. on installing from each type of media listed below.
  137.  
  138.  
  139. 1.1     Installing from a network CDROM
  140. ---     -------------------------------
  141.  
  142. If you simply wish to install from a local CDROM drive then see the
  143. Quick Start section.  If you don't have a CDROM drive on your system
  144. and wish to use a FreeBSD distribution CD in the CDROM drive of
  145. another system to which you have network connectivity, there are
  146. several ways of going about it:
  147.  
  148. 1. If you would be able to FTP install FreeBSD directly from the CDROM
  149.    drive in some FreeBSD machine, it's quite easy: You simply add the
  150.    following line to the password file (using the vipw command):
  151.  
  152.         ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin
  153.  
  154. And anyone else on your network will now be able to chose a Media type
  155. of FTP and type in: ``ftp://<machine with CDROM drive>'' after picking
  156. "Other" in the ftp sites menu.
  157.  
  158. 2. If you would rather use NFS to export the CDROM directly to the
  159.    machine(s) you'll be installing from, you need to first add an
  160.    entry to the /etc/exports file (on the machine with the CDROM drive)
  161.    which looks something like this:
  162.  
  163.         /cdrom          -ro             ziggy.foo.com
  164.  
  165.    To allow the machine "ziggy.foo.com" to mount the CDROM directly
  166.    via NFS during installation.  The machine with the CDROM must also
  167.    be configured as an NFS server, of course, and if you're not sure how
  168.    to do that then an NFS installation is probably not the best choice
  169.    for you unless you're willing to read up on rc.conf(5) and configure
  170.    things appropriately.  Assuming that this part goes smoothly, you
  171.    should be able to enter:  <cdrom-host>:/cdrom as the path for an NFS
  172.    installation when the target machine is installed.
  173.  
  174.  
  175. 1.2     Installing from Floppies
  176. ---     ------------------------
  177.  
  178. If you must install from floppy disks, either due to unsupported
  179. hardware or just because you enjoy doing things the hard way, you must
  180. first prepare some floppies for the install.
  181.  
  182. First, make a boot floppy as described in floppies/README.TXT
  183.  
  184. Second, read the file LAYOUT.TXT and pay special attention to the
  185. "Distribution format" section since it describes which files you're
  186. going to need to put onto floppy and which you can safely skip.
  187.  
  188. Next you will need, at minimum, as many 1.44MB floppies as it takes to
  189. hold all files in the bin (binary distribution) directory.  If you're
  190. preparing these floppies under DOS, then THESE floppies *must* be
  191. formatted using the MS-DOS FORMAT command.  If you're using Windows,
  192. use the Windows File Manager format command.
  193.  
  194. Don't trust Factory Preformatted floppies!  Format them again
  195. yourself, just to make sure.  Many problems reported by our users in
  196. the past have resulted from the use of improperly formatted media,
  197. which is why I'm taking such special care to mention it here!
  198.  
  199. If you're creating the floppies from another FreeBSD machine, a format
  200. is still not a bad idea though you don't need to put a DOS filesystem
  201. on each floppy.  You can use the `disklabel' and `newfs' commands to
  202. put a UFS filesystem on a floppy, as the following sequence of
  203. commands illustrates:
  204.  
  205.         fdformat -f 1440 fd0.1440
  206.         disklabel -w -r fd0.1440 floppy3
  207.         newfs -t 2 -u 18 -l 1 -i 65536 /dev/rfd0
  208.  
  209. After you've formatted the floppies for DOS or UFS, you'll need to
  210. copy the files onto them.  The distribution files are split into
  211. chunks conveniently sized so that 5 of them will fit on a conventional
  212. 1.44MB floppy.  Go through all your floppies, packing as many files as
  213. will fit on each one, until you've got all the distributions you want
  214. packed up in this fashion.  Each distribution should go into its own
  215. subdirectory on the floppy, e.g.: a:\bin\bin.inf, a:\bin\bin.aa,
  216. a:\bin\bin.ab, ...
  217.  
  218. IMPORTANT NOTE: The bin.inf file also needs to go on the first floppy
  219. of the bin set since it is read by the installation program in order
  220. to figure out how many additional pieces to look for when fetching and
  221. concatenating the distribution.  When putting distributions onto
  222. floppies, the <distname>.inf file MUST occupy the first floppy of each
  223. distribution set!
  224.  
  225. Once you come to the Media screen of the install, select "Floppy" and
  226. you'll be prompted for the rest.
  227.  
  228.  
  229. 1.3     Installing from a DOS partition
  230. ---     -------------------------------
  231.  
  232. To prepare for installation from an MS-DOS partition you should simply
  233. copy the files from the distribution into a directory called
  234. "FREEBSD" on the Primary DOS partition ("Drive C:").  For example, to do
  235. a minimal installation of FreeBSD from DOS using files copied from the
  236. CDROM, you might do something like this:
  237.  
  238.         C:\> MD C:\FREEBSD
  239.         C:\> XCOPY /S E:\BIN C:\FREEBSD\BIN
  240.  
  241. Assuming that `E:' was where your CD was mounted.
  242.  
  243. For as many `DISTS' as you wish to install from DOS (and you have free
  244. space for), install each one in a directory under `C:\FREEBSD' - the
  245. BIN dist is only the minimal requirement.
  246.  
  247. IMPORTANT NOTE: Though you can do all of the above by hand if you
  248. really want to, all of it is much more easily accomplished now by
  249. Robert Nordier's "setup.exe" program.  It will give you a menu of
  250. distribution choices, verify that you have enough free space and do
  251. all the copying to C:\FREEBSD for you automatically.
  252.  
  253. Once you've copied the directories or run setup.exe and let it do all
  254. the work for you, you can simply launch the installation from DOS by
  255. running the install.bat script (NOTE: Some memory managers don't like
  256. this - disable QEMM or EMM386 if they're running before trying this)
  257. or making a boot floppy as described in section 0.1.
  258.  
  259.  
  260. 1.4     Installing from QIC/SCSI Tape
  261. ---     -----------------------------
  262.  
  263. When installing from tape, the installation program expects the files
  264. to be simply tar'ed onto it, so after fetching all of the files for
  265. the distributions you're interested in, simply tar them onto the tape
  266. with a command something like this:
  267.  
  268.         cd /where/you/have/your/dists
  269.         tar cvf /dev/rwt0 (or /dev/rst0) dist1 .. dist2
  270.  
  271. When you go to do the installation, you should also make sure that you
  272. leave enough room in some temporary directory (which you'll be allowed
  273. to choose) to accommodate the FULL contents of the tape you've
  274. created.  Due to the non-random access nature of tapes, this method of
  275. installation requires quite a bit of temporary storage!  You should
  276. expect to require as much temporary storage as you have stuff written
  277. on tape.
  278.  
  279. SPECIAL NOTE: When going to do the installation, the tape must be in
  280. the drive *before* booting from the boot floppy.  The installation
  281. "probe" may otherwise fail to find it.
  282.  
  283. Now create a boot floppy as described in section 0.1 and proceed with
  284. the installation.
  285.  
  286.  
  287. 1.5     Installing over a network using FTP or NFS
  288. ---     ------------------------------------------
  289.  
  290. After making a boot floppy as described in the first section, you can
  291. load the rest of the installation over a network using one of 3 types
  292. of connections:
  293.  
  294.         Serial port:    SLIP / PPP
  295.         Parallel port:  PLIP (using ``laplink'' style cable)
  296.         Ethernet:       A standard Ethernet controller (including
  297.                         certain PCCARD devices).
  298.  
  299. Serial Port
  300. -----------
  301.  
  302. SLIP support is rather primitive, and is limited primarily to
  303. hard-wired links, such as a serial cable running between two
  304. computers.  The link must be hard-wired because the SLIP installation
  305. doesn't currently offer a dialing capability.  If you need to dial out
  306. with a modem or otherwise dialog with the link before connecting to
  307. it, then I recommend that the PPP utility be used instead.
  308.  
  309. If you're using PPP, make sure that you have your Internet Service
  310. Provider's IP address and DNS information handy as you'll need to know
  311. it fairly early in the installation process.  You may also need to
  312. know your own IP address, though PPP supports dynamic address
  313. negotiation and may be able to pick up this information directly from
  314. your ISP if they support it.
  315.  
  316. You will also need to know how to use the various "AT commands" for
  317. dialing out with your particular brand of modem as the PPP dialer
  318. provides only a very simple terminal emulator.
  319.  
  320.  
  321. Parallel Port
  322. -------------
  323.  
  324. If a hard-wired connection to another FreeBSD (2.0R or later) or Linux
  325. machine is available, you might also consider installing over a
  326. "laplink" style parallel port cable.  The data rate over the parallel
  327. port is much higher than what is typically possible over a serial line
  328. (up to 50k/sec), thus resulting in a quicker installation.  It's not
  329. typically necessary to use "real" IP addresses when using a
  330. point-to-point parallel cable in this way and you can generally just
  331. use RFC 1918 style addresses for the ends of the link (e.g. 10.0.0.1,
  332. 10.0.0.2, etc).
  333.  
  334. IMPORTANT NOTE: If you use a Linux machine rather than a FreeBSD
  335. machine as your PLIP peer, you will also have to specify "link0" in
  336. the TCP/IP setup screen's ``extra options for ifconfig'' field.
  337.  
  338.  
  339. Ethernet
  340. --------
  341.  
  342. FreeBSD supports most common PC Ethernet cards, a table of supported
  343. cards (and their required settings) being provided as part of the
  344. FreeBSD Hardware Guide (see the Documentation menu on the boot floppy
  345. or the top level directory of the CDROM).  If you are using one of the
  346. supported PCMCIA Ethernet cards, also be sure that it's plugged in
  347. _before_ the laptop is powered on!  FreeBSD does not, unfortunately,
  348. currently support "hot insertion" of PCMCIA cards during installation.
  349.  
  350. You will also need to know your IP address on the network, the
  351. "netmask" value for your address class and the name of your machine.
  352. Your system administrator can tell you which values are appropriate to
  353. your particular network setup.  If you will be referring to other
  354. hosts by name rather than IP address, you'll also need a name server
  355. and possibly the address of a gateway (if you're using PPP, it's your
  356. provider's IP address) to use in talking to it.
  357.  
  358. If you do not know the answers to these questions then you should
  359. really probably talk to your system administrator _first_ before
  360. trying this type of installation!  Using a randomly chosen IP address
  361. or netmask on a live network will almost certainly get you shot at
  362. dawn.
  363.  
  364. Once you have a network connection of some sort working, the
  365. installation can continue over NFS or FTP.
  366.  
  367.  
  368. 1.5.1   NFS installation tips
  369. -----   ---------------------
  370.  
  371.         NFS installation is fairly straight-forward: Simply copy the
  372.         FreeBSD distribution files you want onto a server somewhere
  373.         and then point the NFS media selection at it.
  374.  
  375.         If this server supports only "privileged port" access (as is
  376.         generally the default for Sun and Linux workstations), you
  377.         will need to set this option in the Options menu before
  378.         installation can proceed.
  379.  
  380.         If you have a poor quality Ethernet card which suffers from very
  381.         slow transfer rates, you may also wish to toggle the appropriate
  382.         Options flag.
  383.  
  384.         In order for NFS installation to work, the server must also support
  385.         "subdir mounts", e.g. if your FreeBSD 2.2 distribution directory
  386.         lives on:  ziggy:/usr/archive/stuff/FreeBSD
  387.         Then ziggy will have to allow the direct mounting of
  388.         /usr/archive/stuff/FreeBSD, not just /usr or /usr/archive/stuff.
  389.  
  390.         In FreeBSD's /etc/exports file this is controlled by the
  391.         ``-alldirs'' option.  Other NFS servers may have different
  392.         conventions.  If you are getting `Permission Denied' messages
  393.         from the server then it's likely that you don't have this
  394.         properly enabled!
  395.  
  396.  
  397. 1.5.2   FTP Installation tips
  398. -----   ---------------------
  399.  
  400.         FTP installation may be done from any mirror site containing a
  401.         reasonably up-to-date version of FreeBSD.  A full menu of
  402.         reasonable choices for almost any location in the world is
  403.         provided in the FTP site menu during installation.
  404.  
  405.         If you are installing from some other FTP site not listed in
  406.         this menu, or you are having troubles getting your name server
  407.         configured properly, you can also specify your own URL by
  408.         selecting the ``Other'' choice in that menu.  A URL can
  409.         contain a hostname or an IP address, so the following would
  410.         work in the absence of a name server:
  411.  
  412.                 ftp://192.216.191.11/pub/FreeBSD/2.2-RELEASE
  413.  
  414.         There are two FTP installation modes you can use:
  415.  
  416.            o FTP:
  417.  
  418.              For all FTP transfers, use the standard "Active" mode for
  419.              transfers.  This will not work through most firewalls but
  420.              will often work best with older ftp servers that do not
  421.              support passive mode.  If your connection hangs with
  422.              passive mode, try this one!
  423.  
  424.            o FTP Passive:
  425.  
  426.              For all FTP transfers, use "Passive" mode.  This allows
  427.              the user to pass through firewalls that do not allow
  428.              incoming connections on random port addresses.
  429.  
  430.         NOTE: ACTIVE AND PASSIVE MODES ARE NOT THE SAME AS A `PROXY'
  431.         CONNECTIONS, WHERE A PROXY FTP SERVER IS LISTENING ON A
  432.         DIFFERENT PORT!
  433.  
  434.         In such instances, you should specify the URL as something like:
  435.  
  436.                 ftp://foo.bar.com:1234/pub/FreeBSD
  437.  
  438.         Where "1234" is the port number of the proxy ftp server.
  439.  
  440.  
  441. 2.0     DOS user's Question and Answer section
  442. ---     --------------------------------------
  443.  
  444. 2.1     Help!  I have no space!  Do I need to delete everything first?
  445. ---     --------------------------------------------------------------
  446.  
  447. If your machine is already running DOS and has little or no free space
  448. available for FreeBSD's installation, all is not lost!  You may find
  449. the "FIPS" utility, provided in the tools/ subdirectory on the FreeBSD
  450. CDROM or on the various FreeBSD ftp sites, to be quite useful.
  451.  
  452. FIPS allows you to split an existing DOS partition into two pieces,
  453. preserving the original partition and allowing you to install onto the
  454. second free piece.  You first "defrag" your DOS partition, using the
  455. DOS 6.xx "DEFRAG" utility or the Norton Disk tools, then run FIPS.  It
  456. will prompt you for the rest of the information it needs.  Afterwards,
  457. you can reboot and install FreeBSD on the new partition.  Also note
  458. that FIPS will create the second partition as a "clone" of the first,
  459. so you'll actually see that you now have two DOS Primary partitions
  460. where you formerly had one.  Don't be alarmed!  You can simply delete
  461. the extra DOS Primary partition (making sure it's the right one by
  462. examining its size! :)
  463.  
  464. NOTE: FIPS does NOT currently work with FAT32 or VFAT style partitions
  465. as used by newer versions of Windows 95.  To split up such a
  466. partition, you will need a commercial product such as Partition Magic
  467. 3.0.  Sorry, but this is just the breaks if you've got a Windows
  468. partition hogging your whole disk and you don't want to reinstall from
  469. scratch.
  470.  
  471. 2.2     Can I use compressed DOS filesystems from FreeBSD?
  472. ---     --------------------------------------------------
  473.  
  474. No.  If you are using a utility such as Stacker(tm) or
  475. DoubleSpace(tm), FreeBSD will only be able to use whatever portion of
  476. the filesystem you leave uncompressed.  The rest of the filesystem
  477. will show up as one large file (the stacked/dblspaced file!).  DO NOT
  478. REMOVE THAT FILE as you will probably regret it greatly!
  479.  
  480. It is probably better to create another uncompressed DOS extended
  481. partition and use this for communications between DOS and FreeBSD if
  482. such is your desire.
  483.  
  484.  
  485. 2.3     Can I mount my DOS extended partitions?
  486. ---     ---------------------------------------
  487.  
  488. Yes. DOS extended partitions are mapped in at the end of the other
  489. ``slices'' in FreeBSD, e.g. your D: drive might be /dev/sd0s5, your E:
  490. drive /dev/sd0s6, and so on. This example assumes, of course, that
  491. your extended partition is on SCSI drive 0. For IDE drives, substitute
  492. ``wd'' for ``sd'' appropriately. You otherwise mount extended
  493. partitions exactly like you would mount any other DOS drive, e.g.:
  494.  
  495. mount -t msdos /dev/sd0s5 /dos_d
  496.  
  497.  
  498. 2.4     Can I run DOS binaries under FreeBSD?
  499. ---     -------------------------------------
  500.  
  501. Ongoing work with BSDI's doscmd utility is bringing this much closer to
  502. being a reality in FreeBSD 3.0, though it still has some rough edges.
  503. If you're interested in working on this, please send mail to
  504. emulation@FreeBSD.org and indicate that you're interested in joining
  505. this ongoing effort!
  506.  
  507. There is also a neat utility called "pcemu" in the ports collection
  508. which emulates an 8088 and enough BIOS services to run DOS text mode
  509. applications.  It requires the X Window System (provided as XFree86
  510. 3.2) to operate.
  511.  
  512.  
  513. ---- End of Installation Guide ---
  514.